home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / txm32v21.zip / TXMAIL32.DOC < prev    next >
Text File  |  1997-05-05  |  15KB  |  303 lines

  1.  
  2.                                                         ▄▄     ▄▄
  3.            ▀▀▀▀█▀▀▀▀ █▀▀▀▀▀▀▄ ▄▀▀▀▀▀▀▄ █▄     █ █▀▀▀▀▀▀  ▀█▄ ▄█▀
  4.                █     █▀▀▀▀▀▀▄ █▀▀▀▀▀▀█ █ ▀▀▄▄ █ ▀▀▀▀▀▀█    ▐█▌
  5.                █     █      █ █      █ █     ▀█ ▄▄▄▄▄▄█  ▄█▀ ▀█▄
  6.                                                        ▄█▀     ▀▀
  7.                                                      ▄█▀ Mailer/32
  8.            Internet/Fidonet Transporter            ▄█▀
  9.            Copyrighted Multiboard Communications Centre, 1995-1997
  10.            All rights reserved                 ▄█▀
  11.            Windows 32-bit version            ▄█▀
  12.  
  13. ╓────────────────────────────────────────────────────────────────────────────╖
  14. ║  Introduction                                                              ║
  15. ╙────────────────────────────────────────────────────────────────────────────╜
  16.  
  17.    What is it?
  18.  
  19.      ■ TxMAILER is a package that will use SMTP and POP3 to send and
  20.        retrieve TransX mail bundles from your standard email account.
  21.  
  22.      ■ TxMAILER is only designed to be used with TransX v1.1 or higher
  23.        and does not function as a stand-alone package.
  24.  
  25.    How does it work?
  26.  
  27.      ■ What it does is dial your internet provider over a SLIP/PPP link
  28.        and once connected sends your outbound TransX bundles with SMTP
  29.        then scans your POP3 mailbox for any TransX mail.  If it finds
  30.        any, it will save them to disk for TransX to process and remove
  31.        them from your mailbox.
  32.  
  33.      ■ If you normally use this same mailbox for your personal mail and
  34.        download it with something like Eudora(r), Microsoft Exchange(r)
  35.        or Microsoft Mail/News(r) you will need to take precaution to make
  36.        sure that mail for TransX is not deleted from your mailbox when you
  37.        transfer mail from your host to your machine.  Some of the readers
  38.        mentioned above will allow you to specify whether mail should
  39.        automatically be deleted from your mailbox.  If not you must always
  40.        run TxMAILER before downloading your mail otherwise your regular
  41.        mail client will download all the mail and delete it from the
  42.        mailbox, including the TransX mail rendering TxMAILER useless.
  43.  
  44.      ■ An optimal solution would be to ask your internet provider if you
  45.        can have a secondary mailbox.  Most providers will do this for
  46.        free or for a very nominal charge.  Get your second mailbox named
  47.        something like "userid-tx", in my case "rocca-tx" this would
  48.        become your robot name in TransX, as well as your mailbox name.
  49.        Then all of the TransX mail could be sent and received from
  50.        "userid-tx@yourisp.com" leaving your personal mailbox untouched
  51.        by TransX or TxMAILER.
  52.  
  53.  
  54. ╓───────────────────────────────────────────────────────────────────────────╖
  55. ║ Installing                                                                ║
  56. ╙───────────────────────────────────────────────────────────────────────────╜
  57.  
  58.    You must already have your dial-up networking and dial-up scripting
  59.    setup in Windows 95 or NT before TxMAILER/32 will work.
  60.  
  61.    Installing TxMAILER couldn't be simpler.
  62.  
  63.     1) Simply extract the archived package into the SAME directory
  64.        you have TransX installed into. (if you have not yet installed
  65.        TransX you will need to before installing TxMAILER)
  66.  
  67.     2) Run "TXMAIL32.EXE /SETUP" or manually edit the TXMAIL32.INI
  68.        file to match your Internet settings.  Please be careful here,
  69.        and make sure that the paths already exist.
  70.  
  71.     3) Configure TransX to use SMTP as the Advanced Spool Type.
  72.        Also specify the SMTP In and Out directories.
  73.  
  74.        ┌──┤ Advanced Options ├──────────────────────────┐
  75.        │                                                │
  76.        │  Advanced spool                                │
  77.        │   └ Type     : SMTP (In/Out)                   │
  78.        │                                                │
  79.        │  SMTP options                                  │
  80.        │   ├ SMTP In  : M:\TRANSX\SMTP\IN\              │
  81.        │   ├ SMTP Out : M:\TRANSX\SMTP\OUT\             │
  82.        │   └ Time zone: -0500                           │
  83.        │                                                │
  84.        └────────────────────────────────────────────────┘
  85.  
  86.        Please note that the In and Out directories MUST be different
  87.        from each other, otherwise you will lose mail packets.
  88.  
  89.        You'll also need to configure your General Information to
  90.        reflect your SLIP/PPP setup.
  91.  
  92.        ┌──┤ General Information ├─────────────────────────┐
  93.        │                                                  │
  94.        │  Sysop         : Joe User                   (a)  │
  95.        │  System name   : Joe's BBS System           (b)  │
  96.        │  Domain        : yourisp.com                (c)  │
  97.        │  Site address  : 1:999/9238                 (d)  │
  98.        │  Gate address  : 0:0/0                      (e)  │
  99.        │  Gate netflags : Kill/Direct                (f)  │
  100.        │  Robot name    : transx                     (g)  │
  101.        │                                                  │
  102.        └──────────────────────────────────────────────────┘
  103.  
  104.        (a) Your name
  105.        (b) Your BBS name
  106.        (c) Your providers domain name
  107.        (d) Your main Fidonet style address
  108.        (e) 0:0/0
  109.        (f) Kill/Direct
  110.        (g) Your mailbox name (usually)
  111.  
  112.  
  113. ╓───────────────────────────────────────────────────────────────────────────╖
  114. ║ Running                                                                   ║
  115. ╙───────────────────────────────────────────────────────────────────────────╜
  116.  
  117.    Now you just run TXMAIL32.EXE to transfer your mail whenever needed.
  118.    This will bring up your dial-up networking box if you are not already
  119.    connected to the Internet via either a dial-up or direct LAN.
  120.  
  121.    Once the mail has been sent, you can run TransX again to import any
  122.    received mail.
  123.  
  124.  
  125. ╓────────────────────────────────────────────────────────────────────────────╖
  126. ║  Common Questions and Answers                                              ║
  127. ╙────────────────────────────────────────────────────────────────────────────╜
  128.  
  129.    First of all, thanks for reading this section!  Also please visit
  130.    our updated TX-FAQ page at http://www.multiboard.com/txsupport.html
  131.  
  132.    Q) The mail gets downloaded from my provider ok, and I see it sitting
  133.       in the inbound SMTP directory I have defined, but TransX just
  134.       ignores it?
  135.    A) This is often caused by having the incorrect domain address for
  136.       your provider.  Many providers have their 'root' domain, for
  137.       example "site.com", but email addresses are on another domain
  138.       for example "galaxy.site.com".  You can find out for sure by
  139.       turning on DEBUG logging in TXSETUP, then when you run TransX
  140.       you should see something like:
  141.  
  142.       = Opening at 15 Jun 96  09:50:38
  143.       & 0 routing entries
  144.       & Skip; to userid-tx@storm.site.com (SMTP), from ...
  145.       = Closing at 15 Jun 96  09:50:38
  146.  
  147.       In this case, the domain name is "storm.site.com", and the
  148.       robot name should be "userid-tx"
  149.  
  150.    Q) I can only get one mailbox from my provider, will TxMAILER
  151.       delete my non-TransX mail?
  152.    A) TransX will only download mail that has "Receipt" or "Transport"
  153.       as the subject line.  There is a chance that other mail could
  154.       have these subject lines.  If this is a heavy concern, you should
  155.       seek out another provider who can offer you a second mailbox.
  156.  
  157.    Q) It says that my POP3 username/password is invalid but I know it's
  158.       the right password.
  159.    A) Make sure that you have not included the domain name after the
  160.       POP3 account name.  For example with user@yoursite.com your POP3
  161.       name would probably be "user" not "user@yoursite.com"
  162.  
  163.    Q) What is the BETWEEN.BAT file all about?
  164.    A) If you've received new mail and this file exists it will
  165.       automatically run it.  In this batch file you might have
  166.       something like "TX.EXE /NOEXPORT" which would process your
  167.       new inbound mail and send the receipts to them out right
  168.       away instead of waiting until your next connection.
  169.  
  170.    Q) How can I make my BBS wait while TxMailer runs?
  171.    A) In Windows 95 there is a program called START that allows you
  172.       to launch programs and wait until they complete, so in your
  173.       batch file you could do something like this:
  174.  
  175.       START /W TXMAIL32.EXE
  176.  
  177.       Optionally you can just run TXMAIL32.EXE and put an exit
  178.       statement after so your BBS window completely closes.  You can
  179.       then use the LAUNCH.BAT file to restart your BBS window after
  180.       using something like "START GOBBS.BAT"
  181.  
  182.  
  183. ╓───────────────────────────────────────────────────────────────────────────╖
  184. ║ Support                                                                   ║
  185. ╙───────────────────────────────────────────────────────────────────────────╜
  186.  
  187.    If you have any questions or comments, you can netmail us at FidoNet
  188.    address 1:2401/305 (CM,V34,VFC).  Please poll back for your replies
  189.    as we get dozens of messages a day or optionally make a note that you
  190.    would like your message routed back to you.  You can also contact us
  191.    via the internet for faster responses, and directly sent out replies.
  192.    The address is "support@multiboard.com"
  193.  
  194.    You can also find us in the RA_UTIL echo conference, as well as the
  195.    MCC_SUPPORT echo of course.
  196.  
  197.    The newest MCC software is also available via the internet:
  198.  
  199.    http://www.multiboard.com/
  200.    ftp://ftp.multiboard.com/
  201.  
  202.    You can also "FREQ" the files from us via FidoNet at 1:2401/305
  203.    Our system is online and taking requests 24 hours/day
  204.    The magic name for the newest version of TransX is "TRANSX"
  205.    The magic name for the newest version of TxMAILER is "TXMAILER"
  206.    The magic name for the newest version of TxMAILER/32 is "TXMAIL32"
  207.    Freq "CATALOG" for the newest list of our other products.
  208.  
  209.    You can help us direct your messages by using the alternative email
  210.    addresses when posting us mail:
  211.  
  212.     (1)  support@multiboard.com      -  general inquiries
  213.     (2)  sales@multiboard.com        -  registrations/commercial info
  214.     (3)  suggestions@multiboard.com  -  suggestions
  215.     (4)  reports@multiboard.com      -  bug reports
  216.  
  217.    Thanks for your interest and support!
  218.  
  219.  
  220. ╓───────────────────────────────────────────────────────────────────────────╖
  221. ║ Changes                                                                   ║
  222. ╙───────────────────────────────────────────────────────────────────────────╜
  223.  
  224.   v1.2 - First release of the Windows 32-bit version
  225.  
  226.   v1.3 - Fixes a bug that causes it to not deliver mail properly on
  227.          some systems (hangs with a message "354 enter data", etc..)
  228.        - Added logging features (including DEBUG mode)
  229.        - Added a DELETEALL option to the INI file that will delete
  230.          all non-Transx instead of saving it - good if you have a
  231.          seperate mailbox for TransX and want to delete any stray
  232.          messages that end up in that mailbox that are not for TransX
  233.  
  234.   v1.4 - Enhanced SMTP commands to be 100% RFC-821 compliant
  235.        - Fixed a bug that caused a FAccessViolation error occasionally
  236.  
  237.   v2.0 - Added full configuration program "TXMAIL32.EXE /SETUP"
  238.        - Added a 2 minute timeout while waiting for SMTP host responses
  239.        - Added feature to run BETWEEN.BAT (if it exists) after
  240.          receiving mail, this allows you to run TransX and send
  241.          receipts to messages immediately.
  242.        - Added feature to run LAUNCH.BAT (if it exists) just before
  243.          TxMailer exits (non-damon mode only)
  244.        - Fixed the bug under WinNT 4.0 that said RASAPI32 was missing
  245.        - Reduced the number of cycles the spinner bar takes
  246.        - Increased system responsivness when sending/receiving mail
  247.  
  248.   v2.1 - Fixed a bug that would cause the program to exit before
  249.          receiving all the mail in non-daemon mode
  250.        - Added CPS rate stats to the log file
  251.  
  252.  
  253. ╓───────────────────────────────────────────────────────────────────────────╖
  254. ║ License and Disclaimer                                                    ║
  255. ╙───────────────────────────────────────────────────────────────────────────╜
  256.  
  257.    TxMAILER is FREE, provided you have registered or bought a commercial
  258.    copy of "TransX".  If you are using the unregistered shareware version
  259.    of TransX, then you have fourteen (14) days to evaluate TxMAILER.
  260.  
  261.    TransX is being marketed under the "try before you buy" or the shareware
  262.    concept.  You are entitled to use TransX for a period up to thirty (30)
  263.    days, after which you MUST register or stop using the program.
  264.  
  265.    Registration will also you to use all of the available functions of
  266.    TransX, and help to continue the development of this program.  (not
  267.    to mention maintain the legality of this agreement)
  268.  
  269.    By running any of the executable programs included, you agree that
  270.    Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
  271.    affiliates of the above mentioned are responsible for any damage or
  272.    loss experienced, however so created.  If you cannot agree to this,
  273.    then your privilege to use any of these programs is revoked and it
  274.    becomes illegal for you to execute any programs included with this
  275.    documentation.
  276.  
  277.    You may freely copy and distribute the shareware version of TransX as
  278.    long as its original archived contents are not modified in any way.
  279.    You may NOT distribute any registration keys without the expressed
  280.    written consent of Pete Rocca of Multiboard Communications Centre.
  281.    You may not use a registration key that is not licensed to you by
  282.    Pete Rocca, or any of the registration sites appointed by Pete Rocca.
  283.  
  284.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  285.    any components of TransX or its archive components in any manner.
  286.  
  287.    TransX and its encoding and security algorithms are the legal
  288.    property of Multiboard Communications Centre.  They may not be used
  289.    in any other program other than TransX without the express written
  290.    consent of Pete Rocca of Multiboard Communications Centre.
  291.  
  292.    This product, concept and design are protected by Canadian copyright
  293.    laws and international treaty provisions.  If dispute of any issues
  294.    on legal grounds said above, then governing law of Ontario, Canada
  295.    will rule.  If you agree to all of the above, then you may use
  296.    these programs.
  297.  
  298.    * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU SAVE *
  299.  
  300.    Eudora(r), Microsoft Mail/News(r) and Microsoft Exchange(r) are owned,
  301.    copyrighted and/or trademarked by their respective companies.
  302.  
  303.